start editing
Type
command
Summary
Puts a stack into group-editing mode.
Syntax
start editing <group> [of <stack>]
Description
Use the start editing command to add objects to a group or change the objects in a group.
If you don't specify a stack, the specified group in the current stack is put into group-editing mode.
Any objects created while in group-editing mode are added to that group.
When a group is in group-editing mode, font and color properties for the group (though not for objects in the group) are disregarded. This means that if properties such as textFont, foregroundColor, and so on are set for the group, it displays differently when in group-editing mode, using the fonts and colors of the stack the group is in. As soon as you exit group-editing mode with the stop editing command, the group's correct appearance is restored.
The start editing command temporarily modifies the object hierarchy, displaying only the objects that belong to the group being edited. Inherited font and color properties may not appear correctly while the group is being edited, but will be restored whhen you exit group-editing mode. Also, if the start editing command is included in a handler, using the debugger to step through that handler may cause unexpected results because of the change in object context.
Parameters
Name | Type | Description |
---|---|---|
group | A reference to a group you want to edit. | |
stack | A reference to the stack that contains the group you want to edit. |
Examples
start editing group "container"
Related
glossary: object, inheritance, handler, object hierarchy, group, debugger, command, current stack
object: stack
property: foregroundColor, properties, editBackground, relayerGroupedControls
command: remove, start editing, place, group, stop editing, ungroup
Compatibility and Support
Introduced
LiveCode 1.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile